home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / mus / play / SPlayer_v1_5.lha / Splayer_1.5 / SPlayer.doc < prev    next >
Text File  |  1996-11-22  |  16KB  |  516 lines
  1.  
  2.                        Simple-Player v1.5 - Nov 22, 1996
  3.                        ---------------------------------
  4.  
  5.  
  6.                   Attention IBrowse users that use SPlayer 1.3a.
  7.                   ----------------------------------------------
  8.        Since SPlayer now uses a Standard file passing routine, you must
  9.           re-congigure your IBrowse Preferences to use Splayer 1.5
  10.  
  11.  
  12.  
  13. What's is SimplePlayer ?
  14. ------------------------
  15.  
  16. SPlayer is now MAIL-WARE
  17.  
  18. I have spent many hours on SPlayer. Months to be exact. If you use this
  19. program let me know. You can E-Mail me or send a Post card. The future
  20. of SPlayer relies on this. Since SPlayer is free, I don't think it's much
  21. to ask for a little feedback. Plaese no MUI vs GadTools Flame wars.
  22.  
  23. SimplePlayer is a GUI for Play16. Play16 is a sound utility that lets you
  24. play samples of any size off your Hard Drive.
  25.  
  26. Play16 version 1.6 is included in this archive by permission of it's
  27. Author: Thomas Wenzel. (Thanks Tom!)
  28.  
  29. SimplePlayer controls most of Play16's functions.
  30.  
  31. *****************************************************************************
  32.  
  33. How to install SimplePlayer
  34. ---------------------------
  35.  
  36. Just click on the install Icon..that's it.
  37.  
  38. You can put Simple Player and Play16 wherever you want.
  39.  
  40.   <<<< YOU MUST RUN THE INSTALLER >>>>
  41.  
  42. Failure to do this will cause certain doom....
  43.  
  44. ie: The program will not run as intended.
  45.  
  46. Manual installation is possible.
  47.  
  48. If you want see where the Installer puts everyting, see Bugs and Installation
  49.  
  50. ******************************************************************************
  51.  
  52. Requirements to run SimplePlayer
  53. --------------------------------
  54.  
  55. SimplePlayer will run on any Amiga with Kickstart 2.0+
  56.  
  57. An '020 or higher is recommended for playing 16-Bit samples
  58. at 14-Bit resolution.
  59.  
  60. Read Play16's docs for more info.
  61.  
  62. ******************************************************************************
  63.  
  64. How to use SimplePlayer
  65. -----------------------
  66.  
  67. I'm not going to go into detail about Play16's features. Read Play16's
  68. Docs if you need more info about anything mentioned in this guide
  69.  
  70.  
  71.  
  72.  
  73. (1) TRACK: 00                              (6)  8     - Output
  74.  
  75.  
  76.                        ---                 (7)  DEF   - Screen
  77.                       |   |
  78.                   (3) |   |   (4) 00:00
  79.                       |   |                (8)  OFF   - Loop
  80.                        ---
  81.  
  82.                                            (9)  MODE - (10)  Auto (11) |
  83.  
  84. (2) TOTAL: 00
  85.  
  86.  
  87.  
  88. (5)      READY                             (17)  []   (18)  []
  89.  
  90.  
  91. <<      >      >>     *      ^             (19)  []   (20)  []
  92.  
  93.  
  94. (12)   (13)   (14)   (15)   (16)
  95.  
  96.  
  97.  
  98. (21) [S]
  99.                                                          (22) [*]
  100.  
  101.  
  102.  
  103. 1) The Number of the selected sample that will be played.
  104. 2) The Total Number of samples that were selected.
  105. 3) Shows the current state of SPlayer. Play, Stopped, Pause, etc.
  106. 4) Elapsed time
  107. 5) Shows Sample names and Status info
  108.  
  109. 6) Current Sound Output: 8   : Standard Amiga 8-Bit Audio
  110.  
  111.                          14  : Cunning 14-Bit Amiga Audio
  112.                                If you have any 16-Bit samples,
  113.                                Turn this on. (68000 users beware!)
  114.  
  115.                          14c : Sames as 14-Bit but use calibration
  116.                                See Play16 archive and docs for info
  117.  
  118. 7) Screen      DEF : Select it if run your system in NTSC/PAL
  119.  
  120.                VGA : Select this if you run your system in
  121.                      Multiscan, DoubleNTSC, DoublePAl, etc
  122.  
  123.  
  124. 8) Loop        OFF :  Play the Sample once
  125.  
  126.                ON  :  Repeat Sample forever! (or you can press stop)
  127.  
  128.  
  129.  
  130. 9) Mode - Toggles between Auto/Raw and Strict
  131.  
  132. (10) STRICT:  will only have Play16 play stanard Sound files. Like wav,
  133.      8svx, au, maud, and 16 bit samples. In this mode Non-Sound data will
  134.      not be played. SPlayer will show Playing then stopped. No sound will
  135.      be played.
  136.  
  137.      AUTO: If this gadget is left alone (don't type in it) Play16 will try
  138.      to play anything it comes across. You can even hera what Splayer itself
  139.      sound like.
  140.  
  141.      RAW: As soon as u type in this gadget SPlayer enters raw mode. The
  142.      current or nexr sample will be played ath this frequency. Valid
  143.      ranges are 3500 to 56000 HZ. If Splayer Plays a sample but it sounds
  144.      too fast or slow, use this feature. You can also speed up samples
  145.      or slow them down just for fun.
  146.  
  147.  
  148.   ONLY STANDARD 8 BIT AMIGA SOUND FILES AND WAVS ARE SUPPORTED IN RAW MODE
  149.  
  150.    16 Bit samples and any other formats will only produce noise. Lots of it
  151.  
  152.  
  153. 11) This button simply resets SPlayer to Auto mode. Good to get the sample
  154.     to play back at it's original speed.
  155. 12) Skip - Skip back one Sample. Keep this button pressed and a fast reverse
  156.     search will be done through the sample list.
  157. 13) Play - Play the Sample. Enter "Play" Mode. See the bottom of this page
  158.     for more info on "Play" mode
  159. 14) Skip - Skip forward one Sample. Keep this button pressed and a fast
  160.     forward search will be done through the sample list.
  161. 15) Stop - Stops playing The sample. This will also take you out of
  162.     "Play" mode
  163. 16) Load/Eject - Loads/Ejects the file list of samples. Brings up a file
  164.     requester. Supports Multi-Select
  165. 17) Seq Play - Plays all samples one after another or if unselected
  166.     SPlayer will wait for a Skip forward or back button to be pressed.
  167. 18) Repeat - Loops a singe file or the entire Sample list.
  168. 19) Random - Randomly plays all selected Samples
  169. 20) Filter - Turns the Amiga's Low-Pass Filter (reduces the trebble) on
  170.     or off. Normally you'll want the filter off (that is the default).
  171.     But some samples might sound Dirty, or have a lot of noise, turning
  172.     the filter on might help.
  173. 21) S - Brings up a requester to save out the currently selected file
  174. 22) * - Save Window Position. By pressing this button at any time, the
  175.     current window Position will be saved. The next time you run SPlayer,
  176.     it will appear in the position that you saved it in.
  177.  
  178. Special modes:
  179.  
  180. Play Mode: (Sequencial Play must be off)
  181.  
  182. When you press Play SPlayer goes into Play Mode. The Display will show
  183. ">" and when the sample is finished the Display will show ">|" By pressing
  184. Skip forward or Skip back the sample will play automatically. You do have to
  185. Press play again.
  186.  
  187. Pressing Stop at anytime will exit Play Mode. The Dislay will change
  188. to the Stopped Symbol. This comes in handy when you do not want the next
  189. sample to play immidiately.
  190.  
  191. Play and Reverse Play: (Sequencial Play must be on)
  192.  
  193. When Sequencial Play is enabled (on) All the selected samples will be played
  194. one after another. Pressing > will advamce one Track or more if left
  195. pressed. Playing will continue when the > button is relesed. If you press
  196. < Play will continue as mentioned above but in reverse order.
  197.  
  198. Save Mode:
  199.  
  200. All the files you save out will be in thier native foramt. Voc, wav, aiff
  201. filed will not be converted. Since Play16 can play these files, I see no
  202. need to have SPlayer convert them.
  203.  
  204. *****************************************************************************
  205.  
  206. Stuff to Add
  207. ------------
  208.  
  209. If you like, use, and reccommend this program to your friends, let me know.
  210. I like to hear good things about my work.
  211.  
  212. Stuff that I'll add soon (maybe):
  213.  
  214. - Improve SPlayers Command line handling
  215.  
  216. - clean up and optomize SPlayer's code
  217.  
  218. - Add a Global save Prefs option.
  219.  
  220. Any suggestions welcome..
  221.  
  222. You can E-MAil me at:  favers@execulink.com
  223.  
  224. *****************************************************************************
  225.  
  226. Bugs and Installation
  227. ---------------------
  228.  
  229. Firstly..Make sure you read the entire docs and Play's docs on the proper
  230. use of these programs before sending me any Bug reports. Also, the installer
  231. is included for a good reason..use it!
  232.  
  233. If there is any bizarre misbehavour of SimplePlayer on your system
  234. let me know. Make note of your Amiga model, OS version, and Programs
  235. you might have run at startup.
  236.  
  237. The following files are used by Simple-Player:
  238.  
  239.  
  240. C: Directory
  241.  
  242.                 Copy
  243.                 Break
  244.                 Status
  245.                 * Led
  246.                 * Play16
  247.                 + RequestFile
  248.  
  249.  
  250. S: Directory
  251.  
  252.                 *SPlayer.images
  253.                 *SPlayer.pos
  254.  
  255.  
  256. Fonts: Directory
  257.  
  258.                 *Topaz/8
  259.                 *Topaz/11
  260.                 *Topaz.font
  261.  
  262.                 *SPlayer/10f
  263.                 *SPlayer.font
  264.  
  265.                 *SPlayerB/11f
  266.                 *SPlayerb.font
  267.  
  268.  
  269. * - These files are installed by the Installer program
  270.  
  271. + - RequestFile is Standard on 3.x Systems. On 2.x, Simon Dick's
  272.     RequestFile v37.4 is copied here by the Installer.
  273.  
  274. Normal "Behaviour"
  275.  
  276. The Timer may skip seconds from time to time, especially when 14-Bit modes
  277. and VGA screens are involved. Don't worry, the Timer will catch up to the
  278. actual time within a few seconds.
  279.  
  280. If SPlayer is called from the cli or a Web Browser but refuses to play the
  281. sound sample, low chip-mem is usually to blame.
  282.  
  283. *****************************************************************************
  284.  
  285. The ones responsible...
  286. -----------------------
  287.  
  288. SimplePlayer was written Allan Versaevel.
  289. Play16 was written by Thomas Wenzel.
  290.  
  291. Now the Disclaimer Part (legal stuff):
  292.  
  293. Any Unauthorized distribution outside this archive of either SimplePlayer
  294. or Play16 is strictly prohibited.
  295.  
  296. SimplePlayer Is the copyright of Allan Versaevel.
  297. Play16 is the copyright of Thomas Wenzel
  298.  
  299. Thomas Wenzel and myself are not responsible for any damage to you,
  300. your family, or your computer system, caused directly or indirectly,
  301. by the use of this software package.
  302.  
  303. Use at your own risk...
  304.  
  305. Boy, glad that's over with...
  306.  
  307. Hope you enjoy this program.
  308.  
  309. -----------------------------------------------------------------------------
  310.  
  311. E-Mail: favers@execulink.com
  312.  
  313. Allan Versaevel
  314. 679 Miller Street
  315. Woodstock, Onatrio
  316. Canada. N4S-5K2
  317.  
  318. *****************************************************************************
  319.  
  320.  
  321. Excellent Jobs Everyone!
  322.  
  323. Many Thanks To The Following People:
  324.  
  325.  
  326. Beta Testers:
  327. -------------
  328.  
  329. John Pszeniczny - Yoi!
  330.  
  331. Christian Birchinger - Batman beware, the Joker is back!
  332.  
  333. ------------------------------------------------------------------------------
  334.  
  335. Thomas Wenzel -  Play16's Author. Thanks for The best sound utility on the
  336.                  planet.
  337.  
  338. ------------------------------------------------------------------------------
  339.  
  340. Simon Dick - Author of Requestfile V37.4
  341.  
  342. ------------------------------------------------------------------------------
  343.  
  344. Olli Wagner - For his continuing support for the Amiga and for any help he
  345.               gave me.
  346.  
  347. ------------------------------------------------------------------------------
  348.  
  349. Many thanks to those who replied with thier suggestions and
  350. bug reports.
  351.  
  352. *****************************************************************************
  353.  
  354. @Node History "A Simple History Of Simple Player"
  355.  
  356.  
  357. v1.5  -  Fixed Random routine bug.
  358.       -  Added a Custom Font for the Elapsed timer. Easier to read
  359.       -  Cleaned up Splayer's GUI. 20 lines smaller
  360.       -  Added CD-like Display Grahphics
  361.       -  Killed some redundant code.
  362.  
  363. v1.4  -  Can now be used with IBrowse and AWeb.
  364.       -  Supports saving of soundfiles. If you liked what you listened
  365.          to, you can now save it out. Great for Web Browsing.
  366.       -  SPlayer can now handle one command line argument.
  367.          ie: "SPlayer Sys:Sound/sample.iff". Can be used with any program
  368.          or via the shell.
  369.       -  "Smart"" Random Play added.
  370.       -  Replaced the Eject Graphic with a more stanradized one.
  371.       -  c:version command comptable.
  372.       -  varoius bug fixes.
  373.  
  374. v1.3a -  Added IBrowse Support. Now SPlayer can be called up by IBrowse
  375.          to play sound files off the net.
  376.  
  377. v1.3  -  Now you can save SPlayer's Window position.
  378.       -  Random Play feature has been added.
  379.       -  Reverse Play feature added
  380.       -  GUI has been moderately changed. Looks better.
  381.       -  Fixed Font Bug. Splayer will adapt it's window to the Window
  382.          Title's Font.
  383.       -  If a sample list is already loaded and you select load/eject
  384.          but do not select any files (press cancel or close gadget),
  385.          the origibal list will not be erased.
  386.       -  Some Optimizing has been done. Dead, repeatative code has
  387.          been removed.
  388.       -  Various Bug fixes.
  389.  
  390. v1.2  -  Seq Play can be turned on or off
  391.       -  File Requester "remembers" last Directory you were in.
  392.       -  Fast search added.
  393.       -  Elapsed "Real Time" Timer added.
  394.       -  Fixed it so that only one Simple Player can be run at a time.
  395.       -  Another slight GUI change.
  396.       -  Killed "50-feet software" ( I was tired when I thought of that one)
  397.          Now My Name appears.
  398.  
  399. v1.1  -  Repeat option added. Will loop lists of samples.
  400.       -  Filter option added. Turns the Amiga's Low-Pass filter on
  401.          and off. Useful for "Dirty" sounding samples.
  402.       -  Slight GUI change to make room for the above mentioned options.
  403.       -  Included RequestFile 34.7 by Simon Dick. Now SimplePlayer will
  404.          run on 2.x machines.
  405.  
  406. v1.0  -  First Public Release of SimplePlayer.
  407.  
  408. v.9   -  Fixed bug #2008. Raid finally did the trick..Got ya !
  409.  
  410. v.8   -  Stop actually works now...
  411.  
  412. v.5   -  Too strange to mention. Fixed it though.
  413.  
  414. v.1   -  First Semi-Useable version of SimplePlayer.
  415.  
  416. V.0   -  Didn't exist yet.
  417.  
  418. *****************************************************************************
  419.  
  420. IBrowse Set-Up
  421. --------------
  422.  
  423. SPlayer can now be called up by IBrowse to play sound files off of
  424. the net. The only exception is if you use IBrowse on FTP sites. IBrowse
  425. uses a different protocol for those pages.
  426.  
  427. How to Set up the IBrowse Preferences to use SPlayer:
  428.  
  429. 1) Go into "Preferences" in IBrowse
  430.  
  431. 2) Select "General"
  432.  
  433. 3) In the Window that pops up click on "Ext.viewer"
  434.  
  435. 4) Select "Add"
  436.  
  437. 5) In "Mime Type" enter "Audio". Press return
  438.  
  439. 6) Enter "*" in the adjacent box. (to the right). Press enter
  440.  
  441. 7) In "Extension" type "wav.voc.aiff,au.maud,iff" pres enter
  442.  
  443. 8) Beside "Action" select the "Ext.viewer" button
  444.  
  445. 9) In the "Viewer" box, type or use the File gadget, enter the path and
  446.    name os SPlayer.
  447.  
  448. 10) In "Arguments" enter %f and press return.
  449.  
  450. 11) Click on "OK"
  451.  
  452. 12) In the "Preferences" menu again, select "Save Settings"
  453.  
  454. That's it. Now whenever you click on a wav, aiff,au,etc. file, Splayer will
  455. pop up and Play the sample.
  456.  
  457. *****************************************************************************
  458.  
  459. AWeb 1.x to 2.0 Set-Up
  460. ----------------------
  461.  
  462. SPlayer can now be called up by Aweb to play sound files off of the net.
  463.  
  464. How to Set up the AWeb Preferences to use SPlayer:
  465.  
  466. 1) Select "Change Settings" from the "Settings" menu
  467.  
  468. 2) use the Page Cycle gadget and keep clicking on it till you reach the
  469.    Mime Type and External Viewer Page
  470.  
  471. 3) Click on ADD
  472.  
  473. 4) Type "AUDIO" in the Type box (left side) and "*" in the box beside it.
  474.  
  475. 5) In "Extensions" enter "wav aiff voc iff maud". Press return
  476.  
  477. 6) In "Command" enter thae path of SPlayer including it's name.
  478.  
  479. 7) In "Arguments" enter %s and press return.
  480.  
  481. 8) Click on "Save"
  482.  
  483. That's it. Now whenever you click on a wav, aiff,au,etc. file, Splayer will
  484. pop up and Play the sample.
  485.  
  486. *****************************************************************************
  487.  
  488. AWeb 2.1 Set-Up
  489. ---------------
  490.  
  491. SPlayer can now be called up by Aweb to play sound files off of the net.
  492.  
  493. How to Set up the AWeb Preferences to use SPlayer:
  494.  
  495. 1) Select "Browser Settings" from the "Settings" menu
  496.  
  497. 2) Select Viewers (5) from that window
  498.  
  499. 3) Click on ADD
  500.  
  501. 4) Type "AUDIO" in the Type box (left side) and "*" in the box beside it.
  502.  
  503. 5) In "Extensions" enter "wav aiff voc iff maud". Press return
  504.  
  505. 6) In "Command" enter thae path of SPlayer including it's name.
  506.  
  507. 7) In "Arguments" enter %s and press return.
  508.  
  509. 8) Click on "Save"
  510.  
  511. That's it. Now whenever you click on a wav, aiff,au,etc. file, Splayer will
  512. pop up and Play the sample.
  513.  
  514.  
  515.  
  516.